home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / base / oztex.txt < prev    next >
Text File  |  1995-03-15  |  6KB  |  157 lines
  1.  
  2.                   LaTeX installation instructions for OzTeX
  3.                   =========================================
  4.  
  5.                               31 August 1994
  6.  
  7. NOTE: LaTeX is installed and ready to use in OzTeX 1.7 and later.
  8. If you have an older version of OzTeX then please upgrade.  Don't expect
  9. any support if you decide to merge this release of LaTeX with an older
  10. version of OzTeX!  If you have OzTeX 1.7 or later then you will only need
  11. to read the following instructions if you decide to update the version of
  12. LaTeX distributed with OzTeX.
  13.  
  14.  
  15. SUMMARY
  16. =======
  17.  
  18. This file contains instructions on how to install LaTeX for OzTeX.
  19. Before reading this file, you should read install.txt which explains
  20. how the LaTeX installation works in more detail.
  21.  
  22. The following sections describe:
  23.  
  24.  * How to save any old version of LaTeX.
  25.  
  26.  * How to unpack the LaTeX distribution.
  27.  
  28.  * How to create the LaTeX format.
  29.  
  30.  * How to check that the installation worked.
  31.  
  32.  * Removing unnecessary files.
  33.  
  34.  
  35. SAVING ANY OLD VERSION OF LATEX
  36. ===============================
  37.  
  38. In OzTeX 1.7, `LaTeX' referred to LaTeX 2.09 and `LaTeX2e' referred to
  39. the beta release of the new LaTeX implementation.  To encourage the idea
  40. that LaTeX 2.09 is out of date and should gradually disappear, `LaTeX' is
  41. now used to refer to the new LaTeX implementation.
  42.  
  43. If you have OzTeX 1.7 and you want to be able to use both LaTeX 2.09 and
  44. the new LaTeX, then carry out the following steps:
  45.  
  46.  * In the `TeX-formats' folder, rename `LaTeX.fmt' to `LaTeX209.fmt' and
  47.    delete `LaTeX2e.fmt' (you will be building a new `LaTeX.fmt' file).
  48.  
  49.  * In the `TeX-inputs' folder, rename the folder `LaTeX' to `LaTeX209'.
  50.    Delete the `LaTeX2e' folder and create a new (empty) `LaTeX' folder.
  51.    (If you'll be installing new versions of the psnfss and graphics packages
  52.    then delete `PSNFSS2e' and `Graphics2e' as well and create new folders
  53.    called `PSNFSS' and `Graphics'.  The installation steps for psnfss and
  54.    graphics can be found in the documentation accompanying these packages.)
  55.  
  56.  * In the `Configs' folder, rename the `LaTeX' config file to `LaTeX209'
  57.    and the `LaTeX2e' config file to `LaTeX'.  Edit these two config files
  58.    and update the format list and TeX input folders to reflect the above new
  59.    format names and TeX input folders.  Similar changes must be made to the
  60.    format list and TeX input folders in the `Default' config file; you must
  61.    also update the config list to show the new config file names.
  62.  
  63. In versions of OzTeX later than 1.7, the above steps are not needed because
  64. only the new LaTeX implementation is distributed.  You should simply delete
  65. all files in the `LaTeX' folder in `TeX-inputs' (after making a backup copy).
  66.  
  67.  
  68. UNPACKING THE DISTRIBUTION
  69. ==========================
  70.  
  71. To unpack the LaTeX distribution:
  72.  
  73.  * Move all files in the distribution to the (empty) `LaTeX' folder in
  74.    `TeX-inputs'.
  75.  
  76.  * Start up OzTeX.
  77.  
  78.  * Select `TeX...' from the `TeX' menu.
  79.  
  80.  * Use the standard file dialogue to select `unpack.ins', but do NOT open
  81.    the file.  Instead, select `Cancel'.  This sets OzTeX's current folder.
  82.  
  83.  * Select `INITEX' from the `TeX' menu.
  84.  
  85.  * Type `unpack.ins' in response to the `**' prompt and hit Return.
  86.  
  87. This will start the unpacking process.  This may take some time:
  88. about 3 hours on an SE, 50 minutes on a IIsi, 30 minutes on a Duo 230,
  89. 16 minutes on a IIfx or 10 minutes on a Quadra 840AV.
  90.  
  91. If you have a copy of MakeIndex, then move all files ending in `.ist'
  92. to your MakeIndex folder.
  93.  
  94.  
  95. CREATING THE LATEX FORMAT
  96. =========================
  97.  
  98. To create the LaTeX format:
  99.  
  100.  * Select `INITEX' from the `TeX' menu.
  101.  
  102.  * Type `latex.ltx' in response to the `**' prompt and hit Return.
  103.  
  104.  * After a short while, you will be asked to save the LaTeX format.
  105.    Save it as `LaTeX.fmt' in the `TeX-formats' folder.
  106.  
  107. You might discover at a later date that some of the TeX parameters in the
  108. `Default' config file need to be increased to typeset your documents.
  109. Depending on which parameters, you might need to build a new format file.
  110. You might even need to build a "big" format; the OzTeX User Guide explains
  111. how to do this.
  112.  
  113.  
  114. CHECKING THAT THE INSTALLATION WORKED
  115. =====================================
  116.  
  117. To check that the installation worked:
  118.  
  119.  * Move the file `ltxcheck.ltx' out of the `LaTeX' folder.
  120.    (It doesn't matter where you move it, just so long as it is not in the
  121.    same folder as the file `article.cls'.  If this file is in the same
  122.    folder then LaTeX will definitely be able to read it and so cannot check
  123.    if it is possible to read files that are NOT in the current folder.)
  124.  
  125.  * Tick the `LaTeX' format in the `TeX' menu.
  126.    If you have LaTeX and LaTeX 2.09 then you should select `LaTeX' from the
  127.    `Config' menu.  This will select the right format and the correct set of
  128.    TeX input folders.
  129.  
  130.  * Select `TeX...' from the `TeX' menu.
  131.  
  132.  * Open the file `ltxcheck.ltx'.
  133.    This will run a test of the LaTeX installation, and should produce `OK!'
  134.    to a number of tests.  If it does not, then see `PROBLEMS' in install.txt.
  135.  
  136.  * Delete the .log and .aux files created (and move `ltxcheck.ltx' back to
  137.    the `LaTeX' folder if you like).
  138.  
  139. You have now installed LaTeX!
  140.  
  141.  
  142. REMOVING UNNECESSARY FILES
  143. ==========================
  144.  
  145. After LaTeX has been successfully installed, you might want to delete some
  146. non-essential files (after making backup copies) to free up space on your
  147. hard disk.  From the `LaTeX' folder, delete all files ending in:
  148.  
  149.    .ins .drv .dtx .fdd.
  150.  
  151.  
  152. --- Copyright 1994 Andrew Trevorrow and the LaTeX3 project. ---
  153. ---                 All rights reserved.                    ---
  154.  
  155.  
  156.  
  157.